<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
<HTML><HEAD>
		<TITLE>User's Reference - Regrid</TITLE>
		<META HTTP-EQUIV="keywords" CONTENT="GRAPHICS VISUALIZATION VISUAL PROGRAM DATA
MINING">
	<meta http-equiv="content-type" content="text/html;charset=ISO-8859-1">
</HEAD><BODY BGCOLOR="#FFFFFF" link="#00004b" vlink="#4b004b">
		<TABLE width=510 border=0 cellpadding=0 cellspacing=0>
			<TR>
				<TD><IMG src="../images/spacer.gif" width=80 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=49 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=24 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=100 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=3 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=127 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=6 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=50 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=71 height=1></TD>
			</TR>
			<TR>
				<TD colspan=9><IMG src="../images/flcgh_01.gif" width=510 height=24 alt="OpenDX - Documentation"></TD>
			</TR>
			<TR>
				<TD colspan=2><A href="../allguide.htm"><IMG src="../images/flcgh_02.gif" width=129 height=25 border="0" alt="Full Contents"></A></TD>
				<TD colspan=3><A href="../qikguide.htm"><IMG src="../images/flcgh_03.gif" width=127 height=25 border="0" alt="QuickStart Guide"></A></TD>
				<TD><A href="../usrguide.htm"><IMG src="../images/flcgh_04.gif" width=127 height=25 border="0" alt="User's Guide"></A></TD>
				<TD colspan=3><B><A href="../refguide.htm"><IMG src="../images/flcgh_05d.gif" width=127 height=25 border="0" alt="User's Reference"></A></B></TD>
			</TR>
			<TR>
				<TD><A href="refgu114.htm"><IMG src="../images/flcgh_06.gif" width=80 height=17 border="0" alt="Previous Page"></A></TD>
				<TD colspan=2><A href="refgu116.htm"><IMG src="../images/flcgh_07.gif" width=73 height=17 border="0" alt="Next Page"></A></TD>
				<TD><A href="../refguide.htm"><IMG src="../images/flcgh_08.gif" width=100 height=17 border="0" alt="Table of Contents"></A></TD>
				<TD colspan=3><A href="refgu009.htm"><IMG src="../images/flcgh_09.gif" width=136 height=17 border="0" alt="Partial Table of Contents"></A></TD>
				<TD><A href="refgu175.htm"><IMG src="../images/flcgh_10.gif" width=50 height=17 border="0" alt="Index"></A></TD>
				<TD><A href="../srchindx.htm"><IMG src="../images/flcgh_11.gif" width=71 height=17 border="0" alt="Search"></A></TD>
			</TR>
		</TABLE>
		<H3><A name="HDRREGRID" ></A>Regrid</H3>
		<A NAME="IDX647"></A><A NAME="IDX648"></A>
<P><STRONG>Category</STRONG>
<P>
<A HREF="refgu008.htm#HDRCATREL">Realization</A>
<P><STRONG>Function</STRONG>
<P>
Maps scattered points onto a grid.
<P><STRONG>Syntax</STRONG>
<PRE><STRONG>
output</STRONG> = Regrid(<STRONG>input, grid, nearest, radius, exponent, missing</STRONG>);
</PRE>
<P><STRONG>Inputs</STRONG>
<BR>
<TABLE BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Name
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Type
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Default
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">Description
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>input</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">field or vector list
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">none
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">field with positions to regrid
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>grid</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">field
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">none
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">grid to be used as template
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>nearest</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">integer or string
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">1
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">number of nearest neighbors to
use
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>radius</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">scalar or string
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">&quot;infinity&quot;
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">radius from grid point
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>exponent</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">scalar
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">1.0
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">weighting exponent
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>missing</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">value
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">no default
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">missing value to be inserted if
necessary
</TD></TR></TABLE>
<P><STRONG>Outputs</STRONG>
<BR>
<TABLE BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">Name
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">Type
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">Description
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%"><TT><STRONG>output</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">field
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">regridded field
</TD></TR></TABLE>
<P><STRONG>Functional Details</STRONG>
<P>
This module uses a specified set of scattered points
(<TT><STRONG>input</STRONG></TT>) to assign data values to
every position of a specified grid.
<TABLE CELLPADDING="3">
<TR VALIGN="TOP"><TD><P><B><TT><STRONG>input</STRONG></TT>
</B></TD><TD><P>should be either (1) a field with a 1-, 2-, or 3-dimensional
"positions" component or (2) a list of 1-, 2-, or
3-dimensional vectors.
In the second case, the vectors are interpreted as positions.
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>grid</STRONG></TT>
</B></TD><TD><P>is required.
It specifies the grid to be used as a base for creating a
"connections" component.
The dimensionality of positions in this grid must match that of the
positions in <TT><STRONG>input</STRONG></TT>.
The specified <TT><STRONG>grid</STRONG></TT> could be created with the
Construct module.
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>nearest</STRONG></TT>
</B></TD><TD><P>must be an integer or the string "infinity."
An integer value specifies the number of nearest points (to each grid
point) to be used in computing an average data value for that
grid point.
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>radius</STRONG></TT>
</B></TD><TD><P>specifies the maximum radius (from the grid point) within which
the
nearest neighbors can be found.
The parameter must specify a scalar value or the string "infinity."

					<P>if 0, will place the data on the nearest grid point.  If more than 1 data values lie within 1/2 delta of a grid point, then the average value will be computed. (Very fast)</P>
				</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>exponent</STRONG></TT>
</B></TD><TD><P>The averaging method is a weighted average.
The expression for this average is
1&#47;radius<SUP><TT><STRONG>(exponent)</STRONG></TT></SUP>.
The default value is 1.0, reducing the expression to the reciprocal of
the radius.
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>missing</STRONG></TT>
</B></TD><TD><P>is used when <TT><STRONG>radius</STRONG></TT> is set to a value
other
than "infinity."
The parameter specifies how to treat those grid points for which no
points in <TT><STRONG>input</STRONG></TT> occur within the specified
radius.
<P>
If <TT><STRONG>missing</STRONG></TT> <I>is not set</I>, the module creates
an "invalid positions" component, and grid points with no
assigned data value are invalidated.
If <TT><STRONG>missing</STRONG></TT> is set, the data value is inserted
for the missing data values.
It must match the data component of <TT><STRONG>input</STRONG></TT> in rank,
type, and shape.
<P>
All components that are position-dependent are treated in the same way
as the "data" component.
</TD></TR></TABLE>
<P><B>Note: </B>To remove invalidated positions, use the Include module.
However, it is not necessary to remove invalidated positions in order to
have them treated as invalid by other modules.
<P><STRONG>Components</STRONG>
<P>
Adds a "connections" component.
The "positions" and "connections" components are those of
<TT><STRONG>grid</STRONG></TT> while all components in
<TT><STRONG>input</STRONG></TT> that depend on
"positions" will be present in the
output, modified by averaging.

		<P>If the <B><TT>grid</TT></B> input contains invalid positions and <B><TT>missing</TT></B> is not set, the grid's invalid positions are replaced with a new invalid positions component computed. If <TT><B>missing</B></TT> is set, then the invalid positions component from the <TT><B>grid</B></TT> input is kept and is in the output.</P>
		<P><STRONG>Example Visual Program</STRONG>
<PRE>

SIMPLE/Regrid.net

</PRE>
<P><STRONG>See Also</STRONG>
<P>
&nbsp;<A HREF="refgu038.htm#HDRCONNECT">Connect</A>,
&nbsp;<A HREF="refgu039.htm#HDRCONSTRU">Construct</A>,
&nbsp;<A HREF="refgu075.htm#HDRINCLUDE">Include</A>,

&nbsp;<A HREF="refgu019.htm#HDRAUTGRID">AutoGrid</A>
		<P>
		<HR>
		<DIV align="center">
			<P><A href="../allguide.htm"><IMG src="../images/foot-fc.gif" width="94" height="18" border="0" alt="Full Contents"></A> <A href="../qikguide.htm"><IMG src="../images/foot-qs.gif" width="94" height="18" border="0" alt="QuickStart Guide"></A> <A href="../usrguide.htm"><IMG src="../images/foot-ug.gif" width="94" height="18" border="0" alt="User's Guide"></A> <A href="../refguide.htm"><IMG src="../images/foot-ur.gif" width="94" height="18" border="0" alt="User's Reference"></A></P>
		</DIV>
		<DIV align="center">
			<P><FONT size="-1">[ <A href="http://www.research.ibm.com/dx">OpenDX Home at IBM</A>&nbsp;|&nbsp;<A href="http://www.opendx.org/">OpenDX.org</A>&nbsp;] </FONT></P>
			<P></P>
		</DIV>
		<P></P>
	</BODY></HTML>
